home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / flips12.arc / FLIPS.DOC < prev    next >
Text File  |  1986-04-17  |  15KB  |  392 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   F L I P S
  8.  
  9.  
  10.  
  11.  
  12.                           Documentation Version 1.0
  13.  
  14.                            Released March 22, 1986
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                     From:
  21.  
  22.                                 John Intorcio
  23.                               247 State Street
  24.                                Northampton, MA
  25.                                     01060
  26.  
  27.  
  28.  
  29.  
  30.  
  31.            These programs are distributed on an "As Is" basis 
  32.            without warranty of any kind, expressed or implied, 
  33.            including but not limited to the implied warranties 
  34.            of merchantability and fitness for a particular 
  35.            purpose. The entire risk as to the quality and 
  36.            performance of these programs is with you.  You (not 
  37.            the author) assume the entire cost of a necessary 
  38.            repair, servicing or correction.  In no event will 
  39.            the author be liable to you for any damages including 
  40.            any lost profits, lost savings, or other incidental 
  41.            or consequential damages arising out of the use or 
  42.            inability to use these programs, even if the author 
  43.            has been advised of the possibility of such damages.  
  44.            You acknowledge that you have read this agreement, 
  45.            understand it, and agree to be bound by its terms and 
  46.            conditions.  You furthermore agree that it is the 
  47.            complete and exclusive statement between you, the 
  48.            user, and the program author, which supersedes any 
  49.            proposal or prior agreement, oral or written, and any 
  50.            other communication between us.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                 Contents
  59.  
  60.  
  61.  
  62. 1.  User Supported Software . . . . . . . . . . . . . . . . . . . . . 1
  63.  
  64. 2.  Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  65.  
  66.    A.   What is FLIPS?. . . . . . . . . . . . . . . . . . . . . . . . 2
  67.  
  68.    B.   FLIPS Files . . . . . . . . . . . . . . . . . . . . . . . . . 2
  69.  
  70.    C.   The Distribution of FLIPS . . . . . . . . . . . . . . . . . . 3
  71.  
  72.    D.   Future Versions of FLIPS. . . . . . . . . . . . . . . . . . . 3
  73.  
  74. 3.  Installing FLIPS. . . . . . . . . . . . . . . . . . . . . . . . . 4
  75.  
  76.    A.   Setting up a Door . . . . . . . . . . . . . . . . . . . . . . 4
  77.  
  78.    B.   Configuring FLIPS . . . . . . . . . . . . . . . . . . . . . . 4
  79.  
  80. 4.  Final Note. . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  81.  
  82.  
  83.  
  84.  
  85.           The Author would like to acknowledge the efforts of
  86.           Charlie Kron and his <ToolBox> bulletin board for
  87.           their help in bringing these programs to life.
  88.           Without their help, none of this would have been
  89.           possible.  Thanks guy!
  90.  
  91.  
  92.  
  93.  
  94.  
  95.                               FLIPS Ver. 1.0                      Page 1
  96.  
  97.  
  98. 1.  User Supported Software
  99.  
  100.  
  101.             You are encouraged to copy and share these programs.
  102.           If, after evaluating these programs you find them useful,
  103.              you are also encouraged to send a contribution to:
  104.  
  105.                                 John Intorcio
  106.                               247 State Street
  107.                            Northampton, MA  01060
  108.  
  109.  
  110.         FLIPS is distributed as User Supported Software.  This method of 
  111.    distributing computer programs is based on the following principals:
  112.  
  113.         A.   That the value and utility of software is best assessed by 
  114.              the user on his or her own system.
  115.  
  116.         B.   That the creation and ongoing development of quality computer 
  117.              software can and should be supported by those who benefit 
  118.              from it.
  119.  
  120.         C.   That the copying and free distribution of programs should be 
  121.              encouraged rather than restricted.
  122.  
  123.         Anyone may legally obtain a copy of these programs for home 
  124.    evaluation from a friend, bulletin board, or computer club at no cost.  
  125.    After you've had a chance to use and evaluate the programs on your own 
  126.    system at your leisure, you are encouraged to either make a small 
  127.    contribution to the support of these programs or discontinue their 
  128.    use.  In either case, your are encouraged to continue to copy and 
  129.    distribute the program for distribution to and evaluation by others.
  130.  
  131.         Free distribution of software and voluntary payment for its use 
  132.    eliminates advertising, distribution, and copy protection costs for the 
  133.    authors, and provides users with quality software at a greatly reduced 
  134.    cost, the ability to evaluate software before purchasing, and exposure 
  135.    to varied products.
  136.  
  137.         Please encourage the User Supported concept.  If you find these 
  138.    principals to your liking, your contribution is solicited to make them 
  139.    work.
  140.  
  141.  
  142.  
  143.                               FLIPS Ver. 1.0                      Page 2
  144.  
  145. 2.  Introduction
  146.  
  147.    A.   What is FLIPS?
  148.  
  149.              FLIPS is a game program written to operate as a "DOOR" from 
  150.         the RBBS-PC Program ((c) Tom Mack).  FLIPS is not meant to operate 
  151.         as a stand-alone program, but solely as an extension of the 
  152.         RBBS-PC Program.  FLIPS expects its instructions to come from a 
  153.         communications port and echoes its output to both the 
  154.         communications port and the host, or SYSOP's, screen.
  155.  
  156.              FLIPS has been tested and shown to operate without fault with 
  157.         RBBS-PC versions 13 and 14 on the IBM PC AT and XT, the Compaq Plus,
  158.         and the ThinkMate Taiwanese clone.  User's who install and operate 
  159.         this software on additional machine types or additional versions 
  160.         of RBBS-PC are encouraged to report their experiences to the 
  161.         author.
  162.  
  163.    B.   FLIPS Files
  164.  
  165.              Flips is comprised of and uses several files.  Each of these, 
  166.         together with a short description of its purpose, is described 
  167.         below.
  168.  
  169.              FLIPSDOR.COM
  170.  
  171.                        This is the compiled version of the actual FLIPS 
  172.                   door, the program that runs the FLIPS game.
  173.  
  174.              FLIPSCON.COM
  175.  
  176.                        This is the FLIPS configuration program that is 
  177.                   used to create a file of defaults for various FLIPS 
  178.                   options.
  179.  
  180.              FLIPS.CNF
  181.  
  182.                        This is the file in which default values and 
  183.                   settings are stored for flips.  It is an ASCII file that 
  184.                   can be directly modified with any editor but is easiest
  185.                   set up using FLIPSCON.COM.
  186.  
  187.              FLIPS.HLP
  188.  
  189.                        This is the file that FLIPS displays when asked for 
  190.                   instructions.  It may be customized to a particular 
  191.                   system or displayed as is.
  192.  
  193.              FLIPS.WEL
  194.  
  195.                        This is the default welcome screen that is 
  196.                   displayed when FLIPS is started.  It should be 
  197.                   customized for your system using any editor.
  198.  
  199.  
  200.                               FLIPS Ver. 1.0                      Page 3
  201.  
  202.  
  203.              FLIPS.PTS
  204.  
  205.                        FLIPS uses this file to store the current count of 
  206.                   games played and games won and lost by the computers 
  207.                   opponents.  This file is not distributed with FLIPS but 
  208.                   will be created the first time that flips is run in the 
  209.                   default directory.
  210.  
  211.              FLIPSDOR.BAS
  212.              FLIPSCON.BAS
  213.  
  214.                        These are the source code files for FLIPSDOR.COM and 
  215.                   FLIPSCON.COM.  They are included so that the user may 
  216.                   customize, improve, or fix the FLIPS programs.  These 
  217.                   are not examples of eloquent programming, but, most of 
  218.                   the time, they work.
  219.  
  220.              FLIPS.DOC
  221.  
  222.                        This documentation file.
  223.  
  224.  
  225.    C.   The Distribution of FLIPS.
  226.  
  227.              FLIPS is distributed for you to use and enjoy.  You are asked 
  228.         not to distribute these programs in modified form.  You are 
  229.         forbidden to charge more than a reproduction charge (the cost of 
  230.         disks and perhaps mailing costs) for the distribution of these 
  231.         programs.
  232.  
  233.    D.   Future Versions of FLIPS.
  234.  
  235.              Future versions of FLIPS will include support for ANSI 
  236.         terminals and feature dynamic board updates, color screens etc.  
  237.         There's no telling when these versions will be made available but 
  238.         they will be released as soon as possible.  Your support will 
  239.         encourage the continued development of FLIPS and other products 
  240.         from John Intorcio.  We ask your support not only in the form of 
  241.         monetary contributions, but also by contributing directly to the 
  242.         development of the programs by supplying bug reports, fixes, 
  243.         comments, or details of improvements that you may have made.
  244.  
  245.  
  246.  
  247.                               FLIPS Ver. 1.0                      Page 4
  248.  
  249.  
  250. 3.  Installing FLIPS.
  251.  
  252.    A.   Setting up a Door.
  253.  
  254.              The procedure for setting up a door is explained in the 
  255.         documentation accompanying the RBBS-PC software and will only be 
  256.         outlined here.
  257.  
  258.              You must use the RBBS-PC CONFIG program to tell your version 
  259.         of RBBS-PC that you will be using doors.  Further, you must list 
  260.         the name of the batch file you wish to use to start in the menu 
  261.         that you are using to display the names of available doors.  The 
  262.         standard name for this file is MENU5 but you may have changed it 
  263.         on your system.
  264.  
  265.              Finally, you must set up a batch file to initiate flips when 
  266.         called from RBBS-PC.  This batch file must contain the proper 
  267.         commands to set the proper directory, initiate the FLIPSDOR.COM 
  268.         program, and return to RBBS-PC upon completion of flips. The 
  269.         name of the batch file must be the name that appears in the doors 
  270.         menu, and the name which the user types to open that particular 
  271.         door.  All this is very confusing.  Please refer to the RBBS-PC 
  272.         documentation for further information.
  273.  
  274.    B. Configuring FLIPS.
  275.  
  276.              Before operating FLIPS, the FLIPS configuration program, 
  277.         FLIPSCON.COM should be used to create a configuration file which 
  278.         will be called FLIPS.CNF.  Each of the configuration items is 
  279.         discussed below.  When through making changes, you may enter a 
  280.         selection of 0 or simply press enter to update the configuration 
  281.         file and exit FLIPSCON.
  282.  
  283.         1.   Bulletin Board Name
  284.  
  285.                   This is the name of the Bulletin Board that you are 
  286.              running as it should be displayed within FLIPS.  FLIPS uses 
  287.              this name when displaying options such as "Return To      ".
  288.  
  289.         2.   Welcome Screen File
  290.  
  291.                   Upon initiation, FLIPS displays a "welcome screen" to 
  292.              inform users of any important information".  This parameter 
  293.              specifies the name of the file that FLIPS is to display.  If 
  294.              FLIPS does not find the file specified by this item, an error 
  295.              message is printed but execution continues.
  296.  
  297.         3.   Path for Welcome Screen
  298.  
  299.                   This is the Pathname to be added to the welcome screen 
  300.              filename when attempting to locate this file.
  301.  
  302.  
  303.  
  304.                               FLIPS Ver. 1.0                      Page 5
  305.  
  306.         4.   Name for RBBS-PC Message File
  307.  
  308.                   This is the name being used for the RBBS-PC message 
  309.              file, usually MESSAGES, which FLIPS uses to obtain the user's 
  310.              communications parameters and name.
  311.  
  312.         5.   Path for RBBS-PC Message File
  313.  
  314.                   Flips uses the message file created by RBBS-PC to obtain 
  315.              the user's communication parameters and name.  This is the 
  316.              path that FLIPS should follow in attempting to locate this 
  317.              file.
  318.  
  319.         6.   Instruction File Name
  320.  
  321.                   Flips is supplied with an instruction file named 
  322.              FLIPS.HLP that is displayed when the user chooses the option 
  323.              to display instructions.  If you wish to change the name of 
  324.              this file, you may inform FLIPS of the change here.
  325.  
  326.         7.   Path for Instruction File
  327.  
  328.                   This is the Pathname to be added to the name of the 
  329.              Instruction file so that FLIPS may locate it.
  330.  
  331.         8.   Line Feed Default
  332.  
  333.                   Flips enables the user to toggle the suppression of line 
  334.              feeds after each line of text that is sent.  This parameter 
  335.              is used to establish the default line feed setting.  A value 
  336.              of one should be entered if line feeds ARE to be sent; a 
  337.              value of zero if they are NOT to be sent.
  338.  
  339.         9.   Graphics Default
  340.  
  341.                   FLIPS enables the user to toggle between two graphics 
  342.              modes: one which uses only standard characters and one which 
  343.              uses the IBM extended ASCII character set.  This parameter is 
  344.              used to establish the default graphics setting.  An entry of 
  345.              one indicates that the extended ASCII characters should be 
  346.              used, an entry of zero indicates that only standard 
  347.              characters are to be used.
  348.  
  349.         10.  Maximum Games Per Session
  350.  
  351.                   This parameter sets the maximum number of games that can 
  352.              be played each time FLIPS is executed.
  353.  
  354.         11.  Maximum Time Per Session
  355.  
  356.                   This parameter sets the maximum number of minutes that 
  357.              the user may spend in the FLIPS program.
  358.  
  359.  
  360.                               FLIPS Ver. 1.0                      Page 6
  361.  
  362.  
  363.  
  364.         12.  Communications Port
  365.  
  366.                   This selection is used to toggle between COM1: and COM2: 
  367.              as the communications port that FLIPS should address.
  368.  
  369.         13.  Pause After Computer Moves
  370.  
  371.                   This parameter is used to set the length of time, in 
  372.              seconds, that the computer will pause to allow the user to 
  373.              see it's move before updating the screen.
  374.  
  375.  
  376. 4.  Final Note.
  377.  
  378.     As a final note, you may wish to consider the use of the program 
  379.     WATCHDOG as described in the RBBS-PC manual.  This program watches 
  380.     over the COM port and will reboot the system if the user drops 
  381.     the carrier.  Without such a program running in the background, it 
  382.     is conceivable that a board may be left sitting in flips with no one 
  383.     on the other end until someone manually resets the system.   The 
  384.     installation and use of this program is described in the RBBS-PC 
  385.     manual and the program itself is available on many bulletin boards.
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.